var express = require('express');
var router = express.Router();

//前端的swagger使用文档注释来生成api文档的

//定于数据模型
/**
 * @swagger
 * definitions:
 *   StudentModel:   #学生的数据类型  
 *     properties:   #属性
 *       _id: 
 *         type:string
 *       name:
 *         type:string
 *       age:
 *         type: number
 */
//---------------------------------------------------

/**
 * @swagger
 * /student:   # 方法的路径
 *  get:   # 请求的方法
 *     tags:     #一个标签把表示那个模块的
 *       - 学生模块
 *     description: 查询所有的学生
 *     produces:      
 *       - application/json   #数据的返回类型
 *     responses:
 *       200:    # 响应码
 *         description: 返回学生的数组
 *         schema:
 *           $ref: '#/definitions/StudentModel'
 */
//查询所有学生
router.get('/', function(req, resp, next) {
    resp.json({"code":0,"msg":"查询成功",
                "datas":[
                    {"_id":"123","name":"张三","gender":"男"},
                    {"_id":"1234","name":"李四","gender":"女"},
                    {"_id":"12345","name":"王五","gender":"男"}
                ]})
});


//查询学生的详细信息
/**
 * @swagger
 * /student/{stuId}/{stuname}:
 *   get:
 *     tags:
 *       - 学生模块
 *     description: 返单个学生
 *     produces:
 *       - application/json
 *     parameters:
 *       - name: stuId
 *         description: 学生的编号
 *         in: path
 *         required: true
 *         type: integer
 *       - name: stuname
 *         description: 学生的姓名
 *         in: path
 *         required: true
 *         type: string
 *     responses:
 *       200:
 *         description: 返回一个学生
 *         schema:
 *           $ref: '#/definitions/StudentModel'
 */
router.get('/:stuId/:stuname', function(req, resp, next) {
    let {stuId,stuname} = req.params;
    resp.json({"code":0,"msg":"查询成功",
              data:{"_id":stuId,"name":stuname,"gender":"男"}
                })
});

//添加学生的详细信息

router.post('/', function(req, resp, next) {
    let {name,gender} = req.body;
    resp.json({"code":0,"msg":"添加成功",
              data:{"_id":"111",name,gender}
                })
});





module.exports = router;
